• 9.4.1 - 2022-09-30
  

  Fixed

  • .setOptionValue() now also clears option source (#1795)
  • TypeScript: add implied to OptionValueSource for option values set by using .implies() (#1794)
  • TypeScript : add undefined to return type of .getOptionValueSource() (#1794)

  Changed

  • additions to README
• 9.4.0 - 2022-07-15
  

  Added

  • preSubcommand hook called before direct subcommands (#1763)

  Fixed

  • export InvalidOptionArgumentError in esm (#1756)

  Changed

  • update dependencies (#1767)
• 9.3.0 - 2022-05-28
  

  Added

  • .summary() for a short summary to use instead of description when listing subcommands in help (#1726)
  • Option.implies() to set other option values when the option is specified (#1724)
  • updated Chinese README with 9.x changes (#1727)

  Fixed

  • TypeScript: add string[] to .options() default value parameter type for use with variadic options (#1721)

  Deprecated

  • multi-character short option flag (e.g. -ws) (#1718)
• 9.2.0 - 2022-04-15
  

  Added

  • conditional export of 'types' for upcoming TypeScript module resolution (#1703)
  • example file showing two ways to add global options to subcommands (#1708)

  Fixed

  • detect option conflicts in parent commands of called subcommand (#1710)

  Changed

  • replace deprecated String.prototype.substr (#1706)
• 9.1.0 - 2022-03-18
  

  Added

  • Option .conflicts() to set conflicting options which can not be specified together (#1678)
  • (developer) CodeQL configuration for GitHub Actions (#1698)
• 9.0.0 - 2022-01-29
  

  Added

  • simpler ECMAScript import (#1589)
  • Option.preset() allows specifying value/arg for option when used without option-argument (especially optional, but also boolean option) (#1652)
  • .executableDir() for custom search for subcommands (#1571)
  • throw with helpful message if pass Option to .option() or .requiredOption() (#1655)
  • .error() for generating errors from client code just like Commander generated errors, with support for .configureOutput (), .exitOverride(), and .showHelpAfterError() (#1675)
  • .optsWithGlobals() to return merged local and global options (#1671)

  Changed

  • Breaking: Commander 9 requires Node.js v12.20.0 or higher
  • update package-lock.json to lockfile@2 format (#1659)
  • showSuggestionAfterError is now on by default (#1657)
  • Breaking: default value specified for boolean option now always used as default value (see .preset() to match some previous behaviours) (#1652)
  • default value for boolean option only shown in help if true/false (#1652)
  • use command name as prefix for subcommand stand-alone executable name (with fallback to script name for backwards compatibility) (#1571)
  • allow absolute path with executableFile (#1571)
  • removed restriction that nested subcommands must specify executableFile (#1571)
  • TypeScript: allow passing readonly string array to .choices() (#1667)
  • TypeScript: allow passing readonly string array to .parse(), .parseAsync(), .aliases() (#1669)

  Fixed

  • option with optional argument not supplied on command line now works when option already has a value, whether from default value or from previous arguments (#1652)

  Removed

  • Breaking: removed internal fallback to require.main.filename when script not known from arguments passed to .parse()
    (can supply details using .name(), and .executableDir() or executableFile) (#1571)
• 9.0.0-1 - 2022-01-14
  

  Added

  • .error() for generating errors from client code just like Commander generated errors, with support for .configureOutput(), .exitOverride(), and .showHelpAfterError() (#1675)
  • .optsWithGlobals() to return merged local and global options (#1671)
• 9.0.0-0 - 2021-12-22
  

  Added

  • simpler ECMAScript import (#1589)
  • Option.preset() allows specifying value/arg for option when used without option-argument (especially optional, but also boolean option) (#1652)
  • .executableDir() for custom search for subcommands (#1571)
  • throw with helpful message if pass Option to .option() or .requiredOption() (#1655)

  Changed

  • Breaking: Commander 9 requires Node.js v12.20.0 or higher
  • update package-lock.json to lockfile@2 format (#1659)
  • showSuggestionAfterError is now on by default (#1657)
  • Breaking: default value specified for boolean option now always used as default value (see .preset() to match some previous behaviours) (#1652)
  • default value for boolean option only shown in help if true/false (#1652)
  • use command name as prefix for subcommand stand-alone executable name (with fallback to script name for backwards compatibility) (#1571)
  • allow absolute path with executableFile (#1571)
  • removed restriction that nested subcommands must specify executableFile (#1571)

  Fixed

  • option with optional argument not supplied on command line now works when option already has a value, whether from default value or from previous arguments (#1652)

  Removed

  • Breaking: removed internal fallback to require.main.filename when script not known from arguments passed to .parse() (can supply details using .name(), and .executableDir() or executableFile) (#1571)
• 8.3.0 - 2021-10-22
  

  Added

  • .getOptionValueSource() and .setOptionValueWithSource(), where expected values for source are one of 'default', 'env', 'config', 'cli' (#1613)

  Deprecated

  • .command('*'), use default command instead (#1612)
  • on('command:*'), use .showSuggestionAfterError() instead (#1612)
• 8.2.0 - 2021-09-10
  Read more
• 8.1.0 - 2021-07-27
• 8.0.0 - 2021-06-25
• 8.0.0-2 - 2021-06-06
• 8.0.0-1 - 2021-05-31
• 8.0.0-0 - 2021-05-22
• 7.2.0 - 2021-03-21
• 7.1.0 - 2021-02-15
• 7.0.0 - 2021-01-15
• 7.0.0-2 - 2020-12-14
• 7.0.0-1 - 2020-11-21
• 7.0.0-0 - 2020-10-25
• 6.2.1 - 2020-12-14
• 6.2.0 - 2020-10-25
• 6.1.0 - 2020-08-28
• 6.0.0 - 2020-07-19
• 6.0.0-0 - 2020-06-20
• 5.1.0 - 2020-04-25
• 5.0.0 - 2020-03-14
• 5.0.0-4 - 2020-03-03
• 5.0.0-3 - 2020-02-20
• 5.0.0-2 - 2020-02-11
• 5.0.0-1 - 2020-02-08
• 5.0.0-0 - 2020-02-01
• 4.1.1 - 2020-02-03
• 4.1.0 - 2020-01-06
• 4.0.1 - 2019-11-11
• 4.0.0 - 2019-11-01
• 4.0.0-1 - 2019-10-08
• 4.0.0-0 - 2019-10-01
• 3.0.2 - 2019-09-26
• 3.0.1 - 2019-08-30
• 3.0.0 - 2019-08-09
• 3.0.0-0 - 2019-07-27
• 2.20.3 - 2019-10-11

• 0b4198d 9.4.1
• c15ae68 Update CHANGELOG for 9.4.1
• 471ec40 Add copyInheritedSettings to README (#1798)
• 8236966 Add mention of makeOptionMandatory in README (#1797)
• 72be61c Add implied to option value sources (#1794)
• 84d9201 setOptionValue should clear option source (#1795)
• 82fcb98 Update CHANGELOG preparing for 9.4.0
• 177cc6e Update dependencies (#1767)
• 2c7f687 feat: add preSubcommand hook (#1763)
• 3ae30a2 Export InvalidOptionArgumentError in esm (#1756)
• dccc906 Bump github/codeql-action from 1 to 2
• 211ff69 Bump actions/checkout from 2 to 3
• becb22f Bump actions/setup-node from 2 to 3
• 3e202f3 Add develop branch for earlier warnings
• fd24e92 Add target-branch
• f2aec26 Prepare for 9.3.0
• e89eca8 chore: Included githubactions in the dependabot config
• 3103c6b Add more tests for implies (#1730)
• 1bab84c Add test for Option passed to wrong routines (#1729)
• 4094e22 chore: Set permissions for GitHub actions
• b2842dc update chinese readme (#1727)
• cc2db5b Add optional summary for short form of subcommand description. (#1726)
• d660967 Add Option.implies() (#1724)
• 1b492d9 Add string[] to options defaultValue type (#1721)

Compare